Tytuî: Konwerter V1.0  (wersja robocza 2.3)
Autor: Krystian Dobrzyïski - KADETT
Data uk.: 2.03.1997
Typ wersji: freeware
Jëzyk: AMOS Pro 2.0


****************************************************************************
*                                                                          *
*                 ! ! ! ! !       U W A G A      ! ! ! ! !                 *
*                                                                          *
*   Nie dajë ûadnej gwarancji na dziaîanie tego programu. Uûywajâc go      *
*                  robisz to na wîasnâ odpowiedzialnoôê !!                 *
*                                                                          *
****************************************************************************


!!! UWAGA !!!  Do poprawnego dziaîania programu niezbëdny jest doîâczony
font HIRES 12 (naleûy umieôciê go w systemowym katalogu FONTS: )


WPROWADZENIE

	Bëdâc w poîowie tworzenia programu, zaczâîem sië zastanawiaê, czy
jest w ogóle sens go koïczyê. Problem konwersji polskich znaków powinien mieê
juû bowiem w Aminecie wîasny katalog (a moûe ma ?). Chciaîem jednak napisaê
program konkretnie dla siebie, który bëdzie zawieraî razem te funkcje, które
sâ mi potrzebne...
	Program wciâû nie jest ukoïczony (mimo wersji roboczej 2.3), ale
uznaîem, ûe dojrzaî juû na tyle, by móc go pokazaê innym i daê mu szansë sië
sprawdziê. Uznaîem takûe, ze program nie jest jeszcze na tyle uniwersalnym i
rozbudowanym narzëdziem, by braê z aniego jakiekolwiek wynagrodzenie, dlatego
teû jest to freeware. Moûecie go swobodnie kopiowaê i uûywaê, moûecie takûe
umieszczaê go na róûnych kompilacjach, w tym jednak szczególnym przypadku
byîbym wdziëczny za informacjë. Dobrze by byîo takûe, aby uûytkownicy tego
programu, w jakiô sposób dali mi o sobie znaê (jakkolwiek - karta pocztowa,
e-mail, etc.), abym mógî choê w przybliûeniu zorientowaê sië, jak wiele osób
tego Konwertera uûywa. Oczywiôcie prawa autorskie naleûâ do mnie, nie wolno
wiëc nic zmieniaê w kodzie programu, czy disassemblowaê go. To chyba tyle
kwoli wstëpu.

MOÛLIWOÔCI PROGRAMU

	Program zasadniczo pisany byî z myôlâ o konwersji tekstów miëdzy
trzema formatami polskich znaków narodowych, a mianowicie Mazovia, Latin II,
oraz AmigaPL. Te wîasnie formaty najczëôciej wykorzystujë w pracy z Amigâ i
drukarkâ. One teû znalazîy sië na pulpicie gîównym programu. Jeôli chodzi o
onwersje, zostaîa teû wprowadzona opcja zastosowania wîasnych danych
konwersyjnych, którâ nazwaîem po prostu "Wîasne kody". Moûna powiedzieê, ûe
jest to odzew na róûne formaty-mutanty uûywane na innych komputerach (np.
PC...brrrr). Jeszcze innâ dodatkowâ funkcjâ programu jest moûliwoôê kodowania
i dekodowania plików. Cykl (de)kodowania jest ôciôle zaleûny od hasîa, nie
jest jednak zbyt skomplikowany. Aczklwiek nie chciaîbym rozkodowywaê tak
przerobionego pliku "na piechotë" ;)
	W przyszîoôci zamierzam przyspieszyê nieco i udoskonaliê procedury
konwersji i (de)kodowania, choê w pierwszym przypadku dziaîajâ one caîkiem
szybko... Mam takûe zamiar dodaê funkcje "formatujâce" tekst, a wiëc
justowanie, centrowanie, rozszerzanie, itp. Chciaîbym po prostu, aby byîo to
sprawne narzëdzie do obróbki plików przede wszystkim w formacie ASCII.

OGÓLNE ZASADY OBSÎUGI

	Sâ pewne czynnoôci, które trzeba wykonywaê bezzmiennie przy kaûdym
rodzaju konwersji. Na poczâtku trzeba wgraê plik przeznaczony do przeróbki.
Sîuûy do tego pierwszy gadûet od lewej strony z dolnej listwy gadûetów
(strzaîka w kierunku "od dyskietki"). Otwiera sië wówczas requester (znany
wszystkim uûytkownikom AMOSa) i moûemy wybraê plik úródîowy. Po wybraniu w
górnym okienku powinna sië pojawiê nazwa pliku z peînâ ôcieûkâ dostëpu.
Moûemy teraz przystâpiê do konwersji (o tym póúniej) a nastëpnie do zapisu
przerobionego pliku. Do tego z kolei sîuûy drugi gadûet na wspomnianej juû
listwie. Znów otwiera sie requester  z domyôlnâ ôcieûkâ dostëpu i nazwâ pliku
takâ jak przy wczytywaniu.

WBUDOWANE RODZAJE KONWERSJI

	Tak jak wspomniaîem sâ to Mazovia, Latin 2, oraz AmigaPL. Moûna
przerabiaê teksty miëdzy tymi formatami w dowolnej kombinacji. Obok nazw
formatow po prawej i po lewej stronie sâ kwadraciki. Klikajâc myszkâ na te
kwadraciki wybieramy format úródîowy (po lewej stronie) i docelowy (po
prawej). Natëpnie (po uprzednim wgraniu pliku oczywiôcie) wybieramy gadûet
"Konwersja" w prawym górnym rogu okna, klikajâc na niego myszkâ. Pojawia sië
dodatkowe okienko, w którym graficznie przedstawiony jest przebieg czasowy
konwersji, po czym, gdy to okno sie zamknie moûemy zgraê przerobiony juû plik
na dysk (nie zgrywa sië automatycznie !!!).

WÎASNE KODY KONWERSJI

	Przebieg samej operacji jest identyczny, jak w przypadku
standardowych konwersji, z tâ maîa róûnicâ, ûe moûemy podaê programowi wîasne
kody úródîowe i docelowe konwersji. Moûemy takûe przerabiaê z kodów wîasnych
na wbudowane i odwrotnie. Musimy jednak stworzyê specjalny plik zawierajâcy
nasze kody. Moûna go napisaê w dowolnym edytorze tekstu w formacie ASCII (np.
Cygnus ED). Kody znaków podawaê bëdziemy w foramcie dziesiëtnym, przy czym na
kaûdy kod przeznaczone sâ trzy cyfry. Oznacza to, ûe jeôli chcemy uûyc kodu
34, to musimy go zapisaê jako 034. A oto budowa pliku (moûe on zawieraê
maksymalnie 19 kodów docelowych plus 19 úródîowych):

Przykîadowy plik úródîowo docelowy:

123-067
032-045
itd.

Po lewj stronie sâ oczywiôcie kody úródîowe, a po prawej kody, w jakie majâ
byê te úródîowe przetworzone. Poîâczone one sâ myôlnikiem. Jeûeli chcemy
stworzyê plik tylko z kodami úródîowymi (jako docelowe chcemy wykorzystaê
wbudowane), bëdzie on wówczas wyglâdaî tak:

123-
032-
itd.

Linie muszâ byê wiëc zakoïczone myôlnikiem. A jesli z kolei interesujâ nas
tylko kody docelowe:

-067
-045
itd.

(DLA LAIKÓW: tego itd. nie piszcie w pliku !!!). Plik zapisujemy jako
tekstowy, a przy pracy z programem. korzystajâc z gadûetu dyskietki z dwoma
znakami zapytania, wgrywamy go do pamiëci. Wówczas przy gadûecie "wîasne", o
ile plik jest stworzony poprawnie pojawiâ sië kwadraciki ( w zaleûnoôci od
tego, czy plik zawiera kody tylko úródlowe bâdú tylko docelowe pojawi sië
jeden kwadracik odpowiednio po lewej lub prawej stronie napisu).
	Wówczas tak jak wspomniaîem postëpujemy zgodnie z opisem w rozdziale
"Wbudowane rodzaje konwersji". Aby uîatwiê wymianë danych z wbudowanymi
formatami zamieszczam tabelë z kolejnoôciâ odpowiednich kodów:


   AmigaPL   Mazovia   Latin II

Â    194       143        164
Ê    202       149        143
Ë    203       144        168
Î    206       156        157
Ï    207       165        227
Ó    211       163        224
Ô    212       152        151
Ú    218       160        141
Û    219       161        189
§    167       168        245
â    226       134        165
ê    234       141        134
ë    235       145        169
î    238       146        136
ï    239       164        228
ó    243       162        162
ô    244       158        152
ú    250       166        171
û    251       167        190


KODOWANIE / DEKODOWANIE

	Po wgraniu pliku úródîowego/docelowego naleûy wpisaê wîasne hasîo
(de)kodowania: W tym celu naleûy wybraê gadûet z kluczem i znakiem zapytania.
Pojawi sie doadatkowe okno z proôbâ o podanie hasîa. Kaûda litera bedzie na
ekranie przedstawiona w postaci gwiazdki (hasîo moûe zawieraê maksymalnie
15 znaków alfanumerycznych - moûe zawieraê mniej, nie moûe jednak nie
zawieraê ûadnego !).
Zakoïczenie hasîa sygnalizujemy wciôniëciem przycisku RETURN. Nastëpnie
odpowiednio do zamiarów wybieramy gadûet ze strzaîkâ skierowanâ zgodnie z
wsadzaniem klucza (kodowanie), lub skierowanâ w przeciwnym kierunku
(dekodowanie). Program sam nie rozpoznaje czy plik jest zakodowany czy teû
nie, teoretycznie jest wiëc moûliwoôê dekodowania pliku niezakodowanego.
Odradzam jednak takie praktyki, ze wzglëdu na to iû procedura kodowania
wykorzystuje funkcje +/- i w przypodku w/w moûe nastâpiê przekroczenie
zakresu 0-255, co skoïczy sië wyjôciem z programu. Plik zakodowany nie
zawiera takûe ûadnych informacji o samym haôle, wiëc radzë je pamiëtaê, lub
gdzieô zapisaê, moûemy bowiem juû nie odzyskaê naszej cennej treôci. Tak wiëc
w wypadku dekodowania z innym hasîem niû plik byî kodowany nie otrzymamy
treôci oryginalnej... Po (de)kodowaniu naleûy oczywiôcie przerobiony plik
zgraê na dysk.

INNE GADÛETY

	Gadûet ze znakiem zapytania wyôwietla krótkâ notkë o autorze. Gadûet
z krzyûykiem to gadûet wyjôcia z programu.

BÎEDY

	Cóû, zawsze jakieô sië zdarzajâ.. :(
	Mogë jedynie przestrzec przed stosowaniem programu niezgodnie z
powyûszâ instrukcjâ. W razie jakichkolwiek bîëdów proszë o kontakt, z
podaniem informacji o konfiguracji sprzëtowej i ôrodowisku uruchamiania
programu (DOS, WB). Adres podany jest na koïcu tego dokumentu.

KONTAKT Z AUTOREM



	Krystian Dobrzyïski (Kadett)
	Osiedle 25/21
	76-042 Rosnowo
		woj. koszaliïskie
		POLSKA

	e-mail:  kadett@termit.ie.tu.koszalin.pl

	telefon: (0-94) 41-12-81, -82, -83,  wewn. 386

